home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / gth035.zip / GTLOGON.HLP < prev    next >
Text File  |  1990-08-11  |  3KB  |  85 lines
  1.  
  2. ╔═════════╦════════════════════════════════════════════════════════════
  3. ║ GT-HELP ║ GTLOGON.BAT and GTLOGOFF.BAT - optional batch files
  4. ╚═════════╩════════════════════════════════════════════════════════════
  5.  
  6.  
  7.     Log-on and log-off batch files are completely optional.  If either
  8.     exists, then it will be executed at the appropriate time.
  9.  
  10.  
  11. ┌───────────────────┐
  12. │ Log-on Batch file │
  13. └───────────────────┘
  14.  
  15.     GTLOGON.BAT, if it exists, will be executed when each caller logs on,
  16.     after displaying the bulletins and before first reaching the main menu.
  17.  
  18.  
  19.     Usually, a log-on batch file must :
  20.  
  21.         a)  redirect input and output to the comms port (see doorgen.hlp)
  22.  
  23.         b)  execute a DOS command or program.
  24.  
  25.         c)  redirect output back to the sysop's screen.
  26.  
  27.     If the program was specifically written to run in a door, it may 
  28.     perform its own redirection.  Read its docs for information.
  29.  
  30.     Note:   Logon programs can be unpopular since they delay access to the
  31.             main menu.  If you put anything there that doesn't run at
  32.             lightning speed, make sure there's some way that the caller can
  33.             terminate it prematurely.
  34.  
  35.  
  36. ┌────────────────────┐
  37. │ Log-off Batch file │
  38. └────────────────────┘
  39.  
  40.     GTLOGOFF.BAT, if it exists, will be executed when the caller selects
  41.     the <G>oodbye option, after GT has displayed the contents of the GTBYE
  42.     file.
  43.  
  44.     Logoff programs usually invoke administrative programs which are
  45.     performed after the caller has gone.  Output redirection is therefore
  46.     not usually required in a logoff batch file.
  47.  
  48.     Typically, a log-off batch file will :
  49.  
  50.     a)  Cause the modem to disconnect from the line, eg :
  51.  
  52.             DROPDTR         (assuming you have such a program and the modem
  53.                              is configured to disconnect when DTR is
  54.                              dropped)
  55.  
  56.     b)  Prevent the modem from auto-answering, if it was previously set up
  57.         to do so.
  58.  
  59.             eg ATS0=0 issued by AT.COM or DOSMODEM.
  60.  
  61.     c)  Optionally, busy the line.
  62.  
  63.             eg ATH1 issued by AT.COM or DOSMODEM.
  64.  
  65.     d)  One or more DOS programs or commands.
  66.  
  67.     GT does not, by itself, drop carrier until the logoff.bat file has
  68.     executed to completion.
  69.  
  70.  
  71. ┌─────────────────────────────┐
  72. │ New User logon/logoff doors │
  73. └─────────────────────────────┘
  74.  
  75.     Two additional batch files are possible.  If they exist, they are
  76.     executed only for first time callers :
  77.  
  78.         GTNLOGON.BAT    executes *before* GTLOGON.BAT
  79.  
  80.         GTNLOGOFF.BAT   executes *before* GTLOGOFF.BAT
  81.  
  82.     These are normally used only for specialised purposes, eg in
  83.     conjunction with companion programs.
  84.  
  85.